IRIX Base Documentation 2001 May/SGI IRIX Base Documentation 2001 May.iso/usr/share/catman/p_man/cat3/librw/RWTValVector.z/RWTValVector

Text File | 1998-10-30 | 6.5 KB | 199 lines

RRRRWWWWTTTTVVVVaaaallllVVVVeeeeccccttttoooorrrr((((3333CCCC++++++++))))                                          RRRRWWWWTTTTVVVVaaaallllVVVVeeeeccccttttoooorrrr((((3333CCCC++++++++))))



NNNNaaaammmmeeee
     RWTValVector<T> - Rogue Wave library class

SSSSyyyynnnnooooppppssssiiiissss
              #include <rw/tvvector.h>



              RWTValVector<T> vec;




DDDDeeeessssccccrrrriiiippppttttoooonnnn
     Class RRRRWWWWTTTTVVVVaaaallllVVVVeeeeccccttttoooorrrr<<<<TTTT>>>> is a simple parameterized vector of objects of type
     TTTT.  It is most useful when you know precisely how many objects have to be
     held in the collection.  If the intention is to "insert" an unknown
     number of objects into a collection, then class RRRRWWWWTTTTVVVVaaaallllOOOOrrrrddddeeeerrrreeeeddddVVVVeeeeccccttttoooorrrr<<<<TTTT>>>>
     may be a better choice.  The class TTTT must have:
          well-defined copy semantics (TTTT::::::::TTTT((((ccccoooonnnnsssstttt TTTT&&&&)))) or equiv.);

          well-defined assignment semantics (TTTT::::::::ooooppppeeeerrrraaaattttoooorrrr====((((ccccoooonnnnsssstttt TTTT&&&&)))) or
          equiv.);

          a default constructor.


PPPPeeeerrrrssssiiiisssstttteeeennnncccceeee
     Isomorphic

EEEExxxxaaaammmmpppplllleeee
              #include <rw/tvvector.h>
          #include <rw/rwdate.h>
          #include <rw/rstream.h>
          main()  {
            RWTValVector<RWDate> week(7);
            RWDate begin;   // Today's date
            for (int i=0; i<7; i++)
              week[i] = begin++;
            for (i=0; i<7; i++)
              cout << week[i] << endl;
            return 0;
          }


     Program output:

              March 16, 1996
          March 17, 1996
          March 18, 1996
          March 19, 1996
          March 20, 1996



                                                                        PPPPaaaaggggeeee 1111






RRRRWWWWTTTTVVVVaaaallllVVVVeeeeccccttttoooorrrr((((3333CCCC++++++++))))                                          RRRRWWWWTTTTVVVVaaaallllVVVVeeeeccccttttoooorrrr((((3333CCCC++++++++))))



          March 21, 1996
          March 22, 1996

PPPPuuuubbbblllliiiicccc CCCCoooonnnnssssttttrrrruuuuccccttttoooorrrrssss
              RRRRWWWWTTTTVVVVaaaallllVVVVeeeeccccttttoooorrrr<<<<TTTT>>>>();


     Constructs an empty vector of length zero.

              RRRRWWWWTTTTVVVVaaaallllVVVVeeeeccccttttoooorrrr<T>(size_t n);


     Constructs a vector of length nnnn.  The values of the elements will be set
     by the default constructor of class TTTT.  For a built in type this can (and
     probably will) be garbage.

              RRRRWWWWTTTTVVVVaaaallllVVVVeeeeccccttttoooorrrr<<<<TTTT>>>>(size_t n, const T& ival);


     Constructs a vector of length nnnn, with each element initialized to the
     value iiiivvvvaaaallll.

              RRRRWWWWTTTTVVVVaaaallllVVVVeeeeccccttttoooorrrr<<<<TTTT>>>>(const RWTValVector& v);


     Constructs self as a copy of vvvv.  Each element in vvvv will be copied into
     self.

              ~~~~RRRRWWWWTTTTVVVVaaaallllVVVVeeeeccccttttoooorrrr<<<<TTTT>>>>();


     Calls the destructor for every element in self.

PPPPuuuubbbblllliiiicccc OOOOppppeeeerrrraaaattttoooorrrrssss
              RWTValVector<T>&
          ooooppppeeeerrrraaaattttoooorrrr====(const RWTValVector<T>& v);


     Sets self to the same length as vvvv and then copies all elements of vvvv into
     self.

              RWTValVector<T>&
          ooooppppeeeerrrraaaattttoooorrrr====(const T& ival);


     Sets all elements in self to the value iiiivvvvaaaallll.

              const T&
          ooooppppeeeerrrraaaattttoooorrrr(((())))(size_t i) const;
          T&
          ooooppppeeeerrrraaaattttoooorrrr(((())))(size_t i);




                                                                        PPPPaaaaggggeeee 2222






RRRRWWWWTTTTVVVVaaaallllVVVVeeeeccccttttoooorrrr((((3333CCCC++++++++))))                                          RRRRWWWWTTTTVVVVaaaallllVVVVeeeeccccttttoooorrrr((((3333CCCC++++++++))))



     Returns a reference to the iiiith value in the vector.  The index iiii must be
     between 0 and the length of the vector less one.  No bounds checking is
     performed.

              const T&
          ooooppppeeeerrrraaaattttoooorrrr[[[[]]]](size_t i) const;
          T&
          ooooppppeeeerrrraaaattttoooorrrr[[[[]]]](size_t i);


     Returns a reference to the iiiith value in the vector.  The index iiii must be
     between 0 and the length of the vector less one.  Bounds checking will be
     performed.

PPPPuuuubbbblllliiiicccc MMMMeeeemmmmbbbbeeeerrrr FFFFuuuunnnnccccttttiiiioooonnnnssss
              const T*
          ddddaaaattttaaaa() const;


     Returns a pointer to the raw data of self.  Should be used with care.

              size_t
          lllleeeennnnggggtttthhhh() const;


     Returns the length of the vector.

              void
          rrrreeeesssshhhhaaaappppeeee(size_t N);


     Changes the length of the vector to NNNN.  If this results in the vector
     being lengthened, then the initial value of the additional elements is
     set by the default constructor of TTTT.





















                                                                        PPPPaaaaggggeeee 3333